Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movies and Your Event Loop

UpdateMovie

The UpdateMovie function allows your application to ensure that the Movie Toolbox properly displays your movie after it has been uncovered.

Your application should call this function between the Window Manager's BeginUpdate and EndUpdate functions. (For details, see Inside Macintosh: Macintosh ToolBox Essentials Essentials.) Do not call MoviesTask at this time. You will observe better display behavior if you call MoviesTask at the end of your update processing.

pascal OSErr UpdateMovie (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The UpdateMovie function does not actually update the movie's graphics world. Rather, the function invalidates the movie's display state so that the Movie Toolbox redraws the movie the next time you call the MoviesTask function. If you need to force a movie to be redrawn outside of a Window Manager update sequence, your application can call UpdateMovie and then call the MoviesTask function (described on page 2-110) to service the movie.

The Movie Toolbox determines the portion of the screen to update by examining the graphics port's visible region.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

For sample code that uses the UpdateMovie function in a Window Manager update sequence, see Listing 2-13 on page 2-54.